Skip to main content
Version: 1.0.2

Add Company

The Add Company API facilitates the onboarding of Company onto the VisaB2B Connect platform. All relevant company details are captured through this API, mapping unique details with the company name.

Method: POST​

{{URL}}/jsonrpc

Headers​

NameValue
Content-Typeapplication/json

Example​

Payload Parameters
ParameterDescription

id

Mandatory

String

Unique ID of request

Example – "1"

method

Mandatory

String

Method Name

Example – "VisaService.AddCompany"

params

Mandatory

Object

api

Mandatory

Object

credential

Mandatory

String

API credential provided by NetXD

Example – "Basic cy5wYXJhbWVzd2FyYW4rMkBiYW5rY2J3Lm9yZzpUZXN0QDEyMzQ="

signature

Mandatory

String

Signature of the digitally signed payload

Example – "MEQCICSDF4HIunb4xDLVEK9IOJYhT6j4wq5FwfJILSb4xbeSAiBdmpkV7uPB+39O6S+ea/61ar3dBmBNSU9ay229vin7sA=="

payload

Mandatory

Object

company

Mandatory

Object

dailyVolume

Optional

String

Maximum limit of transaction amount per day

Example – "9999999"

singleTransaction

Optional

String

Maximum limit of transaction amount per transaction

Example – "25000"

ownershipDetails

Mandatory

Array

isIndividual

Optional

Boolean

Specifying whether customer is an individual or a company

Example – false

entityName

Optional

String

Name of the company

Example – "saran"

address

Optional

String

Address of the company

Example – "chennai"

countryOfBusinessRegistrationISO

Optional

Number

ISO code of business registered country

Example – 840

firstName

Optional

Null

First name of individual

Example – null

lastName

Optional

Null

Last name of individual

Example – null

countryOfResidenceISO

Optional

Null

ISO code of residing country

Example – null

nationalityCountryCodeISO

Optional

Null

ISO code of nationality country

Example – null

orgName

Mandatory

String

Organization name of the company

Example – "TEST12"

emailId

Optional

String

Email Id of the company

Example – "saran.k@gmail.com"

accountNumber

Mandatory

String

Bank Account number of the company

Example – "123456789789412"

routingNumber

Optional

String

Bank's Routing number

Example – "1122"

defaultCurrencyIsoCode

Mandatory

String

ISO code for default currency

Example – "840"

businessRegistrationNumber

Mandatory

String

Registration number of the business/company

Example – "121"

taxId

Mandatory

String

Tax Id of the company

Example – "TAXID7438543"

clabe

Optional

String

unique identifier that is used to track and process banking transactions

Example – "545"

corporateLegalName

Mandatory

String

Legal name of the company

Example – "saran12"

industryCode

Mandatory

String

Industry code of the company

Example – "01"

address1

Mandatory

String

Company address line 1

Example – "chennai"

address2

Optional

String

Company address line 2

Example – "chennai"

unitNo

Optional

String

Unit number of the company

Example – "897"

city

Optional

String

City where the company is located

Example – "chennai"

state

Optional

String

State where the company is located

Example – "TN"

postalCode

Optional

String

Postal code of the company's location

Example – "600028"

countryIsoCode

Mandatory

String

Country ISO code where the company is located

Example – "840"


curl --location --globoff '{{URL}}/jsonrpc' \
--header 'Content-Type: application/json' \
--data-raw '{"id":"1","method":"VisaService.AddCompany","params":{"api":{"credential":"Basic c3VwcG9ydCsxQG5ldHN5cy1pbmMuY29tOjM5ZDYxOGJkNTVmNzQ4ZGQ4ZWY4NWI5NWQxY2RlNDE5","signature":"MEQCICSDF4HIunb4xDLVEK9IOJYhT6j4wq5FwfJILSb4xbeSAiBdmpkV7uPB+39O6S+ea/61ar3dBmBNSU9ay229vin7sA=="},"payload":{"company":{"dailyVolume":"9999999","singleTransaction":"25000","ownershipDetails":[{"isIndividual":false,"entityName":"saran","address":"chennai","countryOfBusinessRegistrationISO":840,"firstName":null,"lastName":null,"countryOfResidenceISO":null,"nationalityCountryCodeISO":null}],"orgName":"TEST12","emailId":"saran.k@gmail.com","accountNumber":"123456789789412","routingNumber":"1122","defaultCurrencyIsoCode":"840","businessRegistrationNumber":"121","taxId":"TAXID7438543","clabe":"545","corporateLegalName":"saran12","industryCode":"01","address1":"chennai","address2":"chennai","unitNo":"897","city":"chennai","state":"TN","postalCode":"600028","countryIsoCode":"840"}}}}'

Body​


{
  "id": "1",
  "method": "VisaService.AddCompany",
  "params": {
    "api": {
      "credential": "Basic c3VwcG9ydCsxQG5ldHN5cy1pbmMuY29tOjM5ZDYxOGJkNTVmNzQ4ZGQ4ZWY4NWI5NWQxY2RlNDE5",
      "signature": "MEQCICSDF4HIunb4xDLVEK9IOJYhT6j4wq5FwfJILSb4xbeSAiBdmpkV7uPB+39O6S+ea/61ar3dBmBNSU9ay229vin7sA=="
    },
    "payload": {
      "company": {
        "dailyVolume": "9999999",
        "singleTransaction": "25000",
        "ownershipDetails": [
          {
            "isIndividual": false,
            "entityName": "saran",
            "address": "chennai",
            "countryOfBusinessRegistrationISO": 840,
            "firstName": null,
            "lastName": null,
            "countryOfResidenceISO": null,
            "nationalityCountryCodeISO": null
          }
        ],
        "orgName": "TEST12",
        "emailId": "saran.k@gmail.com",
        "accountNumber": "123456789789412",
        "routingNumber": "1122",
        "defaultCurrencyIsoCode": "840",
        "businessRegistrationNumber": "121",
        "taxId": "TAXID7438543",
        "clabe": "545",
        "corporateLegalName": "saran12",
        "industryCode": "01",
        "address1": "chennai",
        "address2": "chennai",
        "unitNo": "897",
        "city": "chennai",
        "state": "TN",
        "postalCode": "600028",
        "countryIsoCode": "840"
      }
    }
  }
}

Response: 200​

Response Parameters
ParameterDescription

companyId

String

Unique identifier of the company

Example – "65e18aa0a5a5039e373ded6a"

bankId

String

Company's bank Id

Example – "12345678"

lastUpdated

String

Date of the last updated information about the company

Example – "03/01/2024"

statusText

String

Status of the company

Example – "ACTIVE"

blockedCorridors

Object

blockedCountries

Array

blockedDesc

String

Description for blocking

Example – "visaBlocked"

isoCountryCode

Number

ISO code of country where company is located

Example – 4

countryCode

String

Country code where company is located

Example – "AFG"

countryDisplayName

String

Country name

Example – "AFGHANISTAN"

transactionLimits

Object

customLimits

String

True, if Custom limits applicable

Example – true

dailyVolume

String

Maximum limit of transaction amount per day

Example – "9999999"

singleTransaction

String

Maximum limit of transaction amount per transaction

Example – "25000"

companyProfile

Object

bankAccountNumber

String

Company's Bank Account Number

Example – "123456789789412"

defaultCurrencyIsoCode

String

ISO code of currency

Example –"357"

doingBusinessAs

String

Name of the company

Example – "TEST12"

businessRegistrationNumber

String

Registration number of the business/company

Example – "121"

taxId

String

Tax Id of the company

Example – "TAXID7438543"

enterpriseId

String

Id of the enterprise

Example – "V-USA-EUR-10080373-100000001-001"

clabe

String

unique identifier that is used to track and process banking transactions

Example – "545"

corporateLegalName

String

Legal name of the company

Example – "saran12"

bankRoutingNumber

String

Routing number of bank

Example – "1122"

industryCode

String

Industry code of the company

Example – "01"

address

Object

city

String

City where the company is located

Example – "chennai"

unitNo

String

Unit number of the company

Example – "897"

zipCode

String

Postal code of the company's location

Example – "600028"

line1

String

Address line 1

Example – "chennai"

countryIsoCode

Number

ISO Code of the country where company is located

Example – 840

state

String

State where the company is located

Example – "TN"

remitReconcileProfile

Object

remitProfile

Object

frequency

String

Reconciliation frequency

Example – "Every day"

email

String

Email Id of the company

Example – "saran.k@gmail.com"

attachmentFormat

String

Reconciliation file format

Example – "PDF"

deliveryMethod

String

Reconciliation file delivery method

Example – "email"

reconcileProfile

Object

frequency

String

Reconciliation frequency

Example – "Every day"

email

String

Email Id of the company

Example – "saran.k@gmail.com"

attachmentFormat

String

Reconciliation file format

Example – "PDF"

deliveryMethod

String

Reconciliation file delivery method

Example – "email"

ownershipDetails

Array

entityName

String

Name of the company

Example – "saran"

address

String

Address of the company

Example – "chennai"

isIndividual

Boolean

Specifying whether customer is an individual or a company

Example – false

countryOfBusinessRegistrationISO

Number

ISO code of business registered country

Example – 840


{
  "companyId": "65e18aa0a5a5039e373ded6a",
  "bankId": "12345678",
  "lastUpdated": "03/01/2024",
  "statusText": "ACTIVE",
  "blockedCorridors": {
    "blockedCountries": [
      {
        "blockedDesc": "visaBlocked",
        "isoCountryCode": 4,
        "countryCode": "AFG",
        "countryDisplayName": "AFGHANISTAN"
      },
      {
        "blockedDesc": "visaBlocked",
        "isoCountryCode": 8,
        "countryCode": "ALB",
        "countryDisplayName": "ALBANIA"
      },
      {
        "blockedDesc": "visaBlocked",
        "isoCountryCode": 16,
        "countryCode": "ASM",
        "countryDisplayName": "AMERICAN SAMOA"
      },
      {
        "blockedDesc": "visaBlocked",
        "isoCountryCode": 40,
        "countryCode": "AUT",
        "countryDisplayName": "AUSTRIA"
      },
      {
        "blockedDesc": "visaBlocked",
        "isoCountryCode": 16,
        "countryCode": "BRB",
        "countryDisplayName": "BARBADOS"
      },
      {
        "blockedDesc": "visaBlocked",
        "isoCountryCode": 248,
        "countryCode": "ALA",
        "countryDisplayName": "ALAND ISLANDS"
      },
      {
        "blockedDesc": "visaBlocked",
        "isoCountryCode": 533,
        "countryCode": "ABW",
        "countryDisplayName": "ARUBA"
      }
    ]
  },
  "transactionLimits": {
    "customLimits": true,
    "dailyVolume": "9999999",
    "singleTransaction": "25000"
  },
  "companyProfile": {
    "bankAccountNumber": "123456789789412",
    "defaultCurrencyIsoCode": "357",
    "doingBusinessAs": "TEST12",
    "businessRegistrationNumber": "121",
    "taxId": "TAXID7438543",
    "enterpriseId": "V-USA-EUR-10080373-100000001-001",
    "clabe": "545",
    "corporateLegalName": "saran12",
    "bankRoutingNumber": "1122",
    "industryCode": "01",
    "address": {
      "city": "chennai",
      "unitNo": "897",
      "zipCode": "600028",
      "line1": "chennai",
      "countryIsoCode": 840,
      "state": "TN"
    },
    "remitReconcileProfile": {
      "remitProfile": {
        "frequency": "Every day",
        "email": "saran.k@gmail.com",
        "attachmentFormat": "PDF",
        "deliveryMethod": "email"
      },
      "reconcileProfile": {
        "frequency": "Every day",
        "email": "saran.k@gmail.com",
        "attachmentFormat": "PDF",
        "deliveryMethod": "email"
      }
    },
    "ownershipDetails": [
      {
        "entityName": "saran",
        "address": "chennai",
        "isIndividual": false,
        "countryOfBusinessRegistrationISO": 840
      }
    ]
  }
}